Skip to content

[GLUTEN-11550][VL][UT] Enable Variant test suites#11726

Open
baibaichen wants to merge 1 commit intoapache:mainfrom
baibaichen:fix/GlutenVariantEndToEndSuite-GlutenVariantShreddingSuite
Open

[GLUTEN-11550][VL][UT] Enable Variant test suites#11726
baibaichen wants to merge 1 commit intoapache:mainfrom
baibaichen:fix/GlutenVariantEndToEndSuite-GlutenVariantShreddingSuite

Conversation

@baibaichen
Copy link
Contributor

@baibaichen baibaichen commented Mar 9, 2026

What changes are proposed in this pull request?

Enable GlutenVariantEndToEndSuite, GlutenVariantShreddingSuite, and GlutenParquetVariantShreddingSuite for both spark40 and spark41.

Changes:

  1. VeloxValidatorApi.scala: Detect variant shredded structs (produced by Spark's PushVariantIntoScan) by checking for __VARIANT_METADATA_KEY metadata on struct fields. Triggers fallback to Spark's native Parquet reader since Velox cannot read variant shredding encoding.

  2. ParquetMetadataUtils.scala: Refactor to single-pass architecture — extract parquetFooters() returning Iterator[Either[Exception, ParquetMetadata]] to read each footer once. Merge validateVariantAnnotation into isUnsupportedMetadata with metadataValidationEnabled parameter. Variant annotation check is always-on (correctness); codec, timezone, encryption checks are gated by config.

  3. Spark41Shims.scala: Add shouldFallbackForParquetVariantAnnotation to detect Parquet variant logical type annotations. Add needsVariantAnnotationCheck to avoid unnecessary I/O on Spark versions that don't support variant annotations.

  4. pom.xml: Add -Dfile.encoding=UTF-8 to test JVM args. On JDK 17 with LANG=C (CI containers centos-8/9), the default charset is US-ASCII causing garbled output for multi-byte characters. JDK 18+ defaults to UTF-8 via JEP 400. See VariantUtil.java#L508.

How was this patch tested?

  • spark40: GlutenVariantEndToEndSuite 14✅, GlutenVariantShreddingSuite 8✅, GlutenParquetVariantShreddingSuite 5✅
  • spark41: GlutenVariantEndToEndSuite 14✅, GlutenVariantShreddingSuite 8✅, GlutenParquetVariantShreddingSuite 7✅

Was this patch authored or co-authored using generative AI tooling?

Generated-by: GitHub Copilot CLI

Related issue: #11550
Note: This PR subsumes #11723 (GlutenParquetVariantShreddingSuite).

@github-actions github-actions bot added CORE works for Gluten Core VELOX labels Mar 9, 2026
@baibaichen baibaichen force-pushed the fix/GlutenVariantEndToEndSuite-GlutenVariantShreddingSuite branch 3 times, most recently from 4a21089 to 794a1fe Compare March 11, 2026 05:13
@baibaichen baibaichen changed the title [GLUTEN-11550][VL][UT] Enable GlutenVariantEndToEndSuite and GlutenVariantShreddingSuite [GLUTEN-11550][VL][UT] Enable Variant test suites Mar 11, 2026
@github-actions
Copy link

Run Gluten Clickhouse CI on x86

@baibaichen baibaichen force-pushed the fix/GlutenVariantEndToEndSuite-GlutenVariantShreddingSuite branch from 794a1fe to c6759c0 Compare March 11, 2026 09:53
@github-actions
Copy link

Run Gluten Clickhouse CI on x86

@baibaichen baibaichen force-pushed the fix/GlutenVariantEndToEndSuite-GlutenVariantShreddingSuite branch from c6759c0 to d53e74e Compare March 11, 2026 16:15
@github-actions
Copy link

Run Gluten Clickhouse CI on x86

Enable GlutenVariantEndToEndSuite, GlutenVariantShreddingSuite, and
GlutenParquetVariantShreddingSuite for both spark40 and spark41.

Changes:
1. VeloxValidatorApi: Detect variant shredded structs produced by
   Spark's PushVariantIntoScan (checking __VARIANT_METADATA_KEY
   metadata) to trigger fallback to Spark's native Parquet reader.

2. ParquetMetadataUtils: Refactor to single-pass architecture.
   - Extract parquetFooters() returning Iterator[Either[Exception,
     ParquetMetadata]] to read each footer once.
   - Merge validateVariantAnnotation into isUnsupportedMetadata
     with metadataValidationEnabled parameter.
   - Variant annotation check is always-on (correctness); codec,
     timezone, encryption checks are gated by config.
   - VeloxBackend simplified to single validateMetadata() call.

3. Spark41Shims: Add shouldFallbackForParquetVariantAnnotation to
   detect Parquet variant logical type annotations. Add
   needsVariantAnnotationCheck to avoid unnecessary I/O on
   Spark versions that don't support variant annotations.

4. pom.xml: Add -Dfile.encoding=UTF-8 to test JVM args. On JDK 17
   with LANG=C (CI containers centos-8/9), the default charset is
   US-ASCII causing garbled output for multi-byte characters. JDK
   18+ defaults to UTF-8 via JEP 400.
   See: https://github.com/apache/spark/blob/v4.0.1/common/variant/src/main/java/org/apache/spark/types/variant/VariantUtil.java#L508

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@baibaichen baibaichen force-pushed the fix/GlutenVariantEndToEndSuite-GlutenVariantShreddingSuite branch from d53e74e to ff31977 Compare March 13, 2026 14:57
@github-actions
Copy link

Run Gluten Clickhouse CI on x86

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

CORE works for Gluten Core VELOX

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant